Skip to content

docs: adopt agent staff governance and single approval gate - #2672

Open
groupthinking wants to merge 1 commit into
mainfrom
docs/agent-staff-governance
Open

groupthinking wants to merge 1 commit into
mainfrom
docs/agent-staff-governance

Conversation

@groupthinking

Copy link
Copy Markdown
Owner

Canonical issue

Closes #2671

Outcome

Every agent working in this repo (Claude, Gemini, Grok, Jules, Copilot, Hark) runs under one written authority model: five rules, one human approval gate, a standing CI-green merge policy, an inconsistency-to-policy loop, and a hiring brief for each role.

Scope

  • Included: new docs/agent-staff-governance.md; a summary section in AGENTS.md, CLAUDE.md, and GEMINI.md; a CHANGELOG entry.
  • Explicitly excluded: CI or eval enforcement (Promptfoo gate, policy checks), config/agent_network.json role briefs, and branch protection changes. Each lands as a follow-up through the policy loop.

Risk

  • Risk level: low (docs only)
  • Failure mode: agents read the narrower gate as permission to merge something behind it. Mitigation: the gate list is explicit, and MERGE_POLICY.md still applies.
  • Rollback: revert this PR.

Verification

  • AGENTS.md is 6,591 characters, under Grok's 10k cap
  • Required CI
  • Review threads resolved

Production evidence

Not applicable. Documentation only, with no runtime or deploy change.

Agent handoff

  • One canonical issue is linked
  • No competing PR implements the same issue
  • Acceptance criteria are satisfied
  • Required checks pass on the current head
  • Human decision requested: owner approved the protocol with the narrowed gate (Nov 13, 2026)

@vercel

vercel Bot commented Nov 13, 2026 •

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
v0-uvai Ready Ready Preview, v0 Nov 13, 2026 9:56am UTC

@coderabbitai

coderabbitai Bot commented Nov 13, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Nov 13, 2026
@groupthinking
groupthinking marked this pull request as ready for review November 13, 2026 17:57

This branch was successfully deployed

1 active deployment
Preview — edccd81a Deployed Nov 13, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: adopt agent staff governance (five rules, one approval gate, policy loop)

1 participant